The Atari Compendium/The Atari Compendium (Toad Computers) (1994).iso/files/compress/expand15.lzh/expando.txt

Text File | 1993-04-07 | 12KB | 238 lines

                             Expand-o-matic:
              Automatic File Extractor (Well, semi-automatic)
                               Version 1.5
                                12/20/92
                              Public Domain
                                   by
                              Andrew Cullum

If you are already familiar with an earlier version, see the attached
update.txt file for a brief list of the changes.

This program may be freely copied so long as all three files (expando.prg,
expando.txt and expand15.rsc) are included in their original
(i.e. unmodified) form.  If you find this program useful you might
consider:
                Sending the author (namely me) $5-10
                Giving blood at your local Red-Cross
                Going out and buying a commercial program at your
                        local ST dealer
                Some other good deed

Thanks to those who gave me help on Pexec(), namely Carlos Sara,
Carlos Varela and Richard Syratt (Hope I got the names right, I'm
going from memory)

And Thanks to Fred Koch and Gordon Meyer for their suggestions for the
upgrade.

And forgive me, this is my first attempt at documentation.


So, what's it do?

Expand-o-matic is a shell for dealing with a variety of compressed
formats.  Most shells that I have seen allow you to do everything
that the various archivers can do, i.e. archive, extract, list files,
etc.  The problem with this is that they are not as convenient as they
might be.  As I almost never do anything other than extract files, I
decided to write a shell that is more convenient, at the price of
not being able to do the other functions.  Thus, after much swearing
and reading of manuals (normally in that order, and repeated several
times), was born Expand-o-matic.  The first time you run the program,
you will need to set it up (see the section on Setup below), to
tell it which archive types you deal with, and where the program for
that type is located.  After that, just give it the name of the file,
or if you are using NeoDesk or a Tos version of 2.05 or higher, drag
the file onto the Expando.prg icon, and off it goes .  It looks at
the extension of the file you give it, and calls the appropriate
program for that type of archive.  All this is explained in more
detail below.

Setup:
Before you can extract files with Expand-o-matic you will need to set
everything up.  To do this go to the Setup option under the File menu,
or hit Alt-s.  Across the top of the dialog box that appears it will
say:
        Ext.    Com.            Archive

and have a box beneath each.  Ext. stands for extension.  Click on the
box below it and enter the extension for an archive you deal with,
such as .ARC or .LZH.  If you enter lowercase letters, they will be
converted to uppercase for you.  Com.  stands for command.  This is
the command that is used to extract that type of archive.  For all the
archivers that I know of x is the  command you want, but I thought I would
play it safe and make it configurable.  Click on the box and enter the
appropriate command.  Archive is the program that should be run for
files that end with the extension listed in the first box.  Click on
the box below Archive and a file selector will pop up.  Select the
program you want and click on OK.  The three boxes should then look
something like this:

        .ARC    x       D:\ARCHIVES\ARC602\ARC.TTP

To add another extension, command and program, click on New.  See The
New Button below.

        To set where your files will be extracted to click to the right of
where it says Destination.  A file selector should appear.  Go to
the drive and directory that you want and click on OK.

        To set where it will go to for you to select files, click to the
right of where it says Source.  Select the source directory as you
did for the Destination above.

The New Button:
        Click on the button that says New and you will get a blank entry,
in which to add a second set of extension/command/program information.
Use the arrows on either side of the boxes at the top to scroll
through the sets that you have.

The Delete Button:
        Click on this to delete the set that is currently displayed at
the top.  You will be asked if you are sure that you want to do this.
Click Yes, or hit return, and it will be erased.

The Save Button:
        Click on the Save button to save your current configuration in
a file called EXPANDO.CFG.  Expand-o-matic looks for this file
when it starts up, and reads in the information if it finds it.  The
configuration information is stored in a regular text file, so if
things get messed up it should be easy enough to fix.  If you want to
edit the config file, see 'The Config File' below.

The Reload Button:
        This will read in the current EXPANDO.CFG file, thus returning
all your settings to the last time you saved (the poor man's cancel
option).

The OK Button:
        Use this to exit Setup

The Options Button:
        This button will take you to a seperate dialog box, with six
options listed on it.  If the box to the left of the option is
shaded, the option is turned on.  The options are:

Continue Until Cancel?
    If you have a lot of files to extract, click on the box by Continue
Until Cancel.  With this set, after the first archive is done, the
file selector will appear, prompting you for a second.  It will keep
doing this until you hit cancel.

Quit After Auto-run?
    If you check this box the program will automatically quit after
expanding files passed to it from the command line or by dropping
files onto the program.  Thus you just have to drop the file on the
icon, it'll extract it and then quit, you don't have to do anything
else.

Remember Directories?
        If this option is set, the program will keep track of the last
directory that you selected a file from while 'Expand'ing, and go
back to there for you to select the next one.  If this isn't set, the
file selector will go back to the folder you put into the 'Source'
box.  If 'Source' isn't set either, it will go to the folder where
expando.prg is.

Auto-Create Directory?
        If this is set, Expand-o-matic will create a folder with the same
name as the file you are expanding, minus the extension, and expand
the files into there.  For instance, if your 'Destination' is
'd:\newstuff\', and you are unarcing 'neato.arc', it would create
'd:\newstuff\neato\' and unarc the files into there.

Use File Directory?
        If this is set your files will be uncompressed to the same
directory that your archive is located in (or a folder created in
that directory, if you have Auto-Create Directory set).

Prompt For Directory?
        With this option set, after you select the file(s) to uncompress,
you will be presented with another file selector and asked to choose
the directory for the files to be placed in, rather than the
'Destination' or Expando directory being used.  If Auto-create is set
new folders will be created in the directory you select.  You can also
have it prompt you for the directory (without this option being set)
by holding down the alternate key when you select the name of the file
to unarchive.

Extracting Files:
        There are three ways to extract (or expand) files with
Expand-o-matic.  The easiest way, if you use NeoDesk or
TOS 2.05 or higher, is to simply drag the icon for the archive
you want to extract files from onto the icon for EXPANDO.PRG.
The program will the start up and automatically start extracting for
you.  If you pass it more than one file this way, by holding down
shift and selecting them all, Expand-o-matic will deal with each of
them in turn (Note: TOS 2.05 + only seems to pass the first file name
this way, so you can only drop one file at a time).
        The second way is to simply start up the program and go to the Expand
option under the Files menu, or hit Alt-e.  You will then be presented
with a file selector to pick the file that you want it to expand (also
see W